Skip to content

feat: Add BDD (Behavior-Driven Development) semantic anchor#138

Closed
Nantero1 wants to merge 2 commits into
LLM-Coding:mainfrom
Nantero1:add-anchor-bdd
Closed

feat: Add BDD (Behavior-Driven Development) semantic anchor#138
Nantero1 wants to merge 2 commits into
LLM-Coding:mainfrom
Nantero1:add-anchor-bdd

Conversation

@Nantero1

@Nantero1 Nantero1 commented Mar 7, 2026

Copy link
Copy Markdown

Summary

  • Adds BDD (Behavior-Driven Development) as a new semantic anchor
  • Covers Dan North's collaborative specification practice with Given-When-Then scenarios
  • Includes anchor file, all-anchors include, and AgentSkill catalog entry

Why this anchor?

BDD activates: Dan North, specification by example, three amigos, Gherkin syntax, Cucumber/Behave, living documentation, collaboration between devs/QA/business.

Distinct from: Chicago School TDD (developer solo, state-based), London School TDD (developer solo, interaction-based). BDD = team collaboration + outside-in specification.

Files changed

  • docs/anchors/bdd-given-when-then.adoc — new anchor file
  • docs/all-anchors.adoc — added include in Testing & Quality section
  • skill/semantic-anchor-translator/references/catalog.md — added catalog entry

Summary by CodeRabbit

Dokumentation

  • Dokumentation
    • Neue Dokumentation zu Behavior-Driven Development (BDD) hinzugefügt, umfassend die Kerntechniken Given-When-Then, Gherkin-Syntax, Three-Amigos-Ansatz und Living Documentation.
    • Katalog um BDD-Inhalte erweitert mit zugehörigen Referenzen und Best Practices.

Adds BDD as a standalone semantic anchor covering Dan North's
collaborative specification practice. Distinct from TDD (developer
solo practice) — BDD is team collaboration with Given-When-Then
scenarios, three amigos, and living documentation.
@coderabbitai

coderabbitai Bot commented Mar 7, 2026

Copy link
Copy Markdown
Contributor

Warning

Rate limit exceeded

@Nantero1 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 15 minutes and 21 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: db258c8b-762f-4bc6-897f-901d6401f718

📥 Commits

Reviewing files that changed from the base of the PR and between ed1f890 and a9105ae.

📒 Files selected for processing (1)
  • docs/anchors/bdd-given-when-then.adoc

Walkthrough

Diese Pull Request fügt neue Dokumentation und Referenzmaterialien für Behavior-Driven Development (BDD) hinzu. Dabei werden drei Dateien geändert: eine neue BDD-Ankordokumentation, deren Include-Directive in der Übersichtsdatei sowie ein Katalogeintrag mit BDD-Referenzen.

Changes

Cohort / File(s) Zusammenfassung
BDD-Dokumentation
docs/anchors/bdd-given-when-then.adoc
Neue Dokumentationsdatei mit BDD-Konzepten, Kernkonzepten (Given-When-Then, Gherkin, Three Amigos, Living Documentation), Anwendungsszenarien und verwandten Ankern. Metadaten und Kategorisierung enthalten.
Dokumentations- und Katalog-Integration
docs/all-anchors.adoc, skill/semantic-anchor-translator/references/catalog.md
Include-Directive für neue BDD-Ankordokumentation eingefügt; Katalog um BDD-Abschnitt mit Alternativnamen, Proponent (Dan North) und Kernmerkmalen erweitert.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed Der Pull-Request-Titel bezieht sich direkt auf die Hauptänderung: die Hinzufügung von BDD als neuer semantischer Anker.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/anchors/bdd-given-when-then.adoc`:
- Line 32: Die Aussage "Cucumber contributor" in der Zeile starting with "Key
Proponent:: Dan North (\"Introducing BDD\", 2006), creator of JBehave and
Cucumber contributor" ist ungenau; ändere den Text so, dass Dan North als
Urheber von BDD und Schöpfer von JBehave genannt wird und klar gestellt wird,
dass JBehave Cucumbers Design beeinflusste, während Cucumber selbst 2008 von
Aslak Hellesøy entwickelt wurde (z. B. ersetzen durch "creator of JBehave; his
work influenced Cucumber's design — Cucumber was created by Aslak Hellesøy in
2008").

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro

Run ID: c9cf5ee3-fb18-493e-8350-12d498c3d93e

📥 Commits

Reviewing files that changed from the base of the PR and between aefa0b4 and ed1f890.

📒 Files selected for processing (3)
  • docs/all-anchors.adoc
  • docs/anchors/bdd-given-when-then.adoc
  • skill/semantic-anchor-translator/references/catalog.md

Comment thread docs/anchors/bdd-given-when-then.adoc Outdated
Dan North created JBehave which influenced Cucumber's design,
but Cucumber itself was created by Aslak Hellesøy in 2008.
Fixes CodeRabbit review comment.
@Nantero1

Nantero1 commented Mar 7, 2026

Copy link
Copy Markdown
Author

Regarding the CodeRabbit finding on Cucumber attribution — valid, fixed in a9105ae. Dan North created BDD and JBehave, but Cucumber was created by Aslak Hellesøy in 2008. Updated the text to: "creator of JBehave which influenced Cucumber's design (Cucumber created by Aslak Hellesøy, 2008)".

@raifdmueller

Copy link
Copy Markdown
Contributor

Review: ✅ Good anchor, merge-ready.

BDD with the qualifier "Given-When-Then" makes this a precise, attributable anchor (Dan North, 2006). Good content, proper structure, nice distinction from TDD anchors.

Post-merge TODO:

  • Add German translation (bdd-given-when-then.de.adoc)

Merging recommended, translation will follow in batch (see #149).

raifdmueller added a commit to raifdmueller/Semantic-Anchors that referenced this pull request Mar 9, 2026
LLM-Coding#138, LLM-Coding#139)

Content from @Nantero1's original PRs LLM-Coding#138 and LLM-Coding#139, rebased on current main
after merging LLM-Coding#137, LLM-Coding#140, LLM-Coding#142, LLM-Coding#143.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@raifdmueller

Copy link
Copy Markdown
Contributor

Replaced by #152 (rebased on current main to resolve merge conflicts). Content is identical to your original PR. Thank you!

@rdmueller rdmueller closed this Mar 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants